popover: Clarify transitions-enabled deprecation

https://bugzilla.gnome.org/show_bug.cgi?id=769706

diff --git a/gtk/gtkpopover.c b/gtk/gtkpopover.c
index 7aa4bb41f84fbbe43df8d600603dc5003d516933..da5de4d107a78bae5ec8e7b3d68ff3ea447d4ebf 100644 (file)
--- a/gtk/gtkpopover.c
+++ b/gtk/gtkpopover.c
@@ -2338,7 +2338,8 @@ gtk_popover_get_modal (GtkPopover *popover)
  * Since: 3.16
  *
  * Deprecated: 3.22: You can show or hide the popover without transitions
- *   using gtk_widget_show() and gtk_widget_hide().
+ *   using gtk_widget_show() and gtk_widget_hide() while gtk_popover_popup()
+ *   and gtk_popover_popdown() will use transitions.
  */
 void
 gtk_popover_set_transitions_enabled (GtkPopover *popover,
@@ -2369,7 +2370,8 @@ gtk_popover_set_transitions_enabled (GtkPopover *popover,
  * Since: 3.16
  *
  * Deprecated: 3.22: You can show or hide the popover without transitions
- *   using gtk_widget_show() and gtk_widget_hide().
+ *   using gtk_widget_show() and gtk_widget_hide() while gtk_popover_popup()
+ *   and gtk_popover_popdown() will use transitions.
  */
 gboolean
 gtk_popover_get_transitions_enabled (GtkPopover *popover)